home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / vd160r.zip / VD.DOC < prev    next >
Text File  |  1992-10-22  |  30KB  |  997 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.        V       V  A     L     III  DDDD   OOOOO  OOOOO  RRRR
  13.         V     V  A A    L      I   D   D  O   O  O   O  R   R
  14.          V   V  AAAAA   L      I   D   D  O   O  O   O  RRRR
  15.           V V  A     A  L      I   D   D  O   O  O   O  R  R
  16.            V  A       A LLLLL III  DDDD   OOOOO  OOOOO  R   R
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                       Documentation
  28.                       Version  1.60
  29.  
  30.  
  31.  
  32.  
  33.             Copyright (c)1989-92, Cabell B. Clarke Jr.
  34.                     ALL RIGHTS RESERVED.
  35.  
  36.  
  37.                     The Boot Factory BBS
  38.                     --------------------
  39.                      FidoNET 1:264/19
  40.                    3/12/24/96/144 v32bis
  41.                       (804) 262-9289
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  50.  
  51.  
  52. Disclaimer
  53. ----------
  54.  
  55. This software is sold "AS IS".  It is not guaranteed to work at
  56. all. If it trashes your system or ruins your life, you have been
  57. warned.  I am not responsible for any damages incurred from the
  58. use or misuse of this software.
  59.  
  60.  
  61.  
  62. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  63.  
  64.  
  65.  
  66.  
  67. ValidOOR is a User Validation Door written for the RemoteAccess
  68. Bulletin Board System.  ValidOOR allows Sysops to have their
  69. systems call users back in order to verify that they have left a
  70. valid phone number for the sysop's records.  Validoor then
  71. updates the user's BBS record so he can call right back and have
  72. access to the BBS.  This saves the sysops time and trouble of
  73. manually validating users.  Be forewarned *** ValidOOR is NOT
  74. designed to keep unwanted users off of your BBS.  It will not
  75. keep a determined person off.***  It will validate your users so
  76. you don't have to manually do that.
  77.  
  78. ValidOOR is being released as Shareware.  This means you are free
  79. to evaluate the program for 30 days.  If it meets your needs, you
  80. are then expected to register your copy by sending me a
  81. registration fee.  Registering ValidOOR entitles you to all minor
  82. releases of Version 1 of ValidOOR (1.00-1.99).  It also grants
  83. you access to the ValidOOR Support Forum on my BBS which contains
  84. ValidOOR utilities.  There will not be a version 3.00 of ValidOOR
  85. before September of 1993.  Users who register Version 1 of
  86. ValidOOR are entitled to Version 2 free of charge.  There will
  87. possibly be an upgrade fee to version 3 but remember I originally
  88. said the same thing about version 2.
  89.  
  90. Unregistered versions of ValidOOR will have a 30 second delay
  91. built-in to the program.  The KEY file will eliminate this delay
  92. and inform the rest of the world that you have registered your
  93. copy.
  94.  
  95. Please register ValidOOR.  This program has been in development
  96. since December of 1988, and has cost me a lot in the process. 
  97. Support the Shareware concept.  Registration of ValidOOR allows
  98. you to run ValidOOR on one computer system ONLY.
  99.  
  100. In order to register ValidOOR, see the LICENSE.DOC file for an
  101. order entry blank.  Fill out the form and send with the
  102. registration fee to:
  103.                 Cabell Clarke
  104.                 5513 Cottage St.
  105.                 Richmond, VA   23228
  106.  
  107. Your KEY file will be sent to you via FidoNet mail, or US Mail...
  108. whichever is convenient.  Allow 2 weeks for processing.
  109.  
  110.  
  111. A Note about multi-line systems
  112. -------------------------------
  113. At this time, VD does not support file/record locking so it
  114. cannot be reliably used on a multi-node bbs on more than one
  115. node.  It should work fine on one node however.  I would like to
  116. add file/record locking to VD in the future.  Send Code<tm>.
  117.  
  118.  
  119.  
  120. Getting Started
  121. ---------------
  122. In order to get going with VD, first you need to unzip all of the
  123. files into your BBS or ValidOOR directory.  See the file
  124. PACKING.LST which accompanied the VD ZIPchive to make sure you
  125. have all of the necessary files.  I recommend printing this
  126. documentation.  I also recommend printing the VD.CFG file as it
  127. contains helpful hints for setting up the configuration file in
  128. it's comments.
  129.  
  130. Modify (or create) the .MNU .ASC .BAT files included to your
  131. needs.  The enclosed are samples only which I run on my system. 
  132. You are welcome to modify my files for your own use keeping in
  133. mind that my setup may be somewhat different from yours.
  134.  
  135. Rename the vd###.exe to VD.EXE
  136.  
  137.  
  138. Environment Variable
  139. --------------------
  140. You can run ValidOOR in its own sub-directory by setting the
  141. ValidOOR environment variable to that sub-dir.  Two valid
  142. examples are:
  143.  
  144.      set validoor=d:\validoor\
  145.      set validoor=c:\bbs\vd
  146.  
  147. VD will find its sub-dir with or without the trailing backslash. 
  148. You should place your vd.cfg and vd.key (registered users) in
  149. this sub-dir.  If you want to place your executable files in this
  150. directory you should also include it in your path like this:
  151.           path=c:\bbs\vd
  152.  
  153.  
  154. Setting Up vd.cfg
  155. -----------------
  156. The VD.CFG file contains all of the important parameters
  157. necessary to run VD.  Please remember that any line which begins
  158. with a per-cent (%) is a comment and may be removed, however, if
  159. you remove comments, you are on your own.  VD.CFG is
  160. well-commented and should be self explanatory in setting it up. 
  161. Just load it into your text editor.  Make sure that there are no
  162. comments on the lines which contain parameters.  Also make sure
  163. that you only have one (1) space between the Variable Descriptor
  164. and the variable itself like this:
  165.  
  166.      ModemSuffix &M4
  167.                ^
  168.            one space here
  169.  
  170.  
  171.  
  172. NOTE:
  173. In the many versions of ValidOOR there have been several vd.cfg
  174. file formats.  In this version, there are some new descriptors so
  175. it is suggested that you modify the configuration file included
  176. in this archive to suit your setup.  Make sure the vd.cfg file
  177. you are using is compatible with your version of VD.
  178.  
  179.  
  180.  
  181. Variable descriptors in vd.cfg
  182. ------------------------------
  183.  
  184. ---
  185. %
  186. - the percent sign is a comment and must be placed in the first
  187. column of the line that you wish VD to ignore.  Do not place a
  188. '%' on the same line after a variable descriptor or the program
  189. will not operate correctly.
  190.  
  191.  
  192. ---
  193. SysopName
  194. - Your name should go here.  This is required.  Example:
  195.  
  196.      SysopName Cabell Clarke
  197.  
  198.  
  199. ---
  200. SysName1
  201. - One line of text which may be used to describe your system. 
  202. SysName1 is displayed first.  Mine looks like this:
  203.  
  204.      SysName1 Boot Factory BBS - FidoNet 1:264/19
  205.  
  206.  
  207. ---
  208. SysName2
  209. - Another line of text for more info about your system.  SysName2
  210. is displayed after SysName1.
  211.  
  212.      SysName2 Sysop: Cabell Clarke
  213.  
  214.  
  215. ---
  216. Port
  217. - Port tells VD which communications port you are using.  Valid
  218. ports are 0-3 where port 0 = COM1 etc.  If you are using COM1 for
  219. your modem you would need:
  220.  
  221.      Port 0
  222.  
  223.  
  224. ---
  225. DialPrefix
  226. - This is the prefix that tells your modem how to dial out.  Mine
  227. looks like this:
  228.  
  229.      DialPrefix ATDT
  230.  
  231.  
  232. ---
  233. QuickPhone
  234. - This variable is used to tell VD how your BBS saves the user's
  235. phone number.  When a new user logs on if you ask for both Home
  236. Phone Number and Data/Business Phone number then your VD.CFG file
  237. would need the following:
  238.  
  239.      QuickPhone HomePhone
  240.      QuickPhone DataPhone
  241.  
  242. If you only ask them for their Home Phone Number then your VD.CFG
  243. file would only need this:
  244.  
  245.      QuickPhone HomePhone
  246.  
  247.  
  248. ---
  249. AreaCode
  250. - This Variable is used to tell VD which area code(s)you can
  251. place a local call to.  You may have up to 5 local area codes in
  252. VD.CFG...  for instance someone who lives in Washington DC might
  253. have a VD.CFG which looks like this:
  254.  
  255.      AreaCode 202     <-- your area code first
  256.      AreaCode 301
  257.      AreaCode 703
  258.  
  259. This is because he does not need to use an area code to dial any
  260. of these three areas.  Maximum of 5 local area codes supported at
  261. this time. Make sure that your own area code is listed in the
  262. file first.
  263.  
  264.  
  265. ---
  266. YourCodeLD
  267. - This one will allow you to tell VD not to strip your area code
  268. from long distance numbers in your area code - I call this Ed
  269. Marquis mode <grin>.           
  270.      YourCodeLD NoStrip
  271.  
  272. If you don't use this VD will default to stripping them anyway.
  273.  
  274.  
  275. ---
  276. LongDistance
  277. - The LongDistance descriptor enables/disables Long Distance
  278. calling.  If you do not want VD to make a long distance call you
  279. would have the following in your VD.CFG file:
  280.  
  281.      LongDistance NoLDCall
  282.  
  283. If you want VD to make a Long Distance call (whether using slots
  284. or not), you would use:
  285.  
  286.      LongDistance LDCall
  287.  
  288. This one would make long distance calls at any time or allow you
  289. to use the slots below if you want to.
  290.  
  291.  
  292. ---
  293. LDSlotDefault
  294. - This variable tells VD the default slot of time for making long
  295. Distance calls.  This slot is always in effect unless commented
  296. out or overridden by a daily slot.  The correct usage is:
  297.  
  298.      LDSlotDefault <starttime> <stoptime>
  299.  
  300. Example:
  301.  
  302.      LDSlotDefault 2200 0700
  303.  
  304. The above would allow your system to make long distance calls
  305. between 10pm and 7am on all days providing the LongDistance
  306. variable is enabled as shown above.
  307.  
  308.  
  309. ---
  310. LDSlotSun
  311. LDSlotMon
  312. LDSlotTue
  313. LDSlotWed
  314. LDSlotThu
  315. LDSlotFri
  316. LDSlotSat
  317. - These are the daily slots which will override the default slot
  318. above.  The syntax for these is the same as above:
  319.  
  320.      LDSlotSat 0000 2359
  321.      LDSlotSun 0000 1659
  322.  
  323. The two examples above would allow your system to call long
  324. distance all day Saturday and all day before 5pm on Sunday.
  325.  
  326.  
  327. ---
  328. MaxAttempts
  329. - This variable tells VD how many times to attempt to call a user
  330. with NO CONNECT!  If you only wanted to try twice you'd have:
  331.  
  332.      MaxAttempts 2
  333.  
  334. VD will only call once if a connection is made.  This is
  335. hard-coded into the program and cannot be modified.
  336.  
  337.  
  338. ---
  339. ModemTimeOut
  340. - This is the number of seconds you want VD to wait for a carrier
  341. before recycling.  NOTE:  For maximum efficiency You should also
  342. set this value in register S7 of your modem in your modem
  343. initialization string. (S7=45). See ModemInit below.
  344.  
  345.      ModemTimeOut 45
  346.  
  347.  
  348. ---
  349. UserTimeOut
  350. - This is the number of seconds to wait for input from the user
  351. before timing out due to INACTIVITY.
  352.  
  353.      UserTimeOut 40
  354.  
  355.  
  356. ---
  357. YourCitySt
  358. - Tells VD what city and state your BBS resides in to notify the
  359. user where the call will be originating so the user can tell VD
  360. if VD needs to dial a 1 to reach the User.
  361.  
  362.  
  363. ---
  364. ModemInit
  365. - This is the string that you want VD to use to initialize your
  366. modem.  I use this for my HST:
  367.  
  368.      ModemInit AT S0=0 E0 X6 S7=45|
  369.  
  370. Note the s7=45 which is the same as the 45 in the ModemTimeOut
  371. variable above.  If you want VD to ignore result codes use an X0
  372. in this string but remember if you use an X0, all Bad
  373. Number/VOICE connect processing will be eliminated.  The "|"
  374. character adds a carriage return to your string.
  375.  
  376.  
  377. ---
  378. ModemReset
  379. - This variable tells VD whether you want to reset your modem
  380. before you initialize it.  If you want to reset it enter the
  381. string you want to send to it like this:
  382.  
  383.      ModemReset ATZ|
  384.  
  385. Note the '|' sends a carriage return.
  386.  
  387.  
  388. ---
  389. LogPath
  390. - This is the path to your VD Log File where a log of VD's
  391. activities are kept.  I use:
  392.  
  393.      LogPath d:\qbbs\validoor.log
  394.  
  395.  
  396.  
  397.  
  398. ---
  399. LogStyle
  400. - this allows you to make your log look like an Opus/Binkley or
  401. FrontDoor style log.  Valid descriptors are:
  402.  
  403.      LogStyle BINK
  404.      LogStyle FD
  405.  
  406.  
  407. ---
  408. ExitInfoPath
  409. - another optional descriptor which tells VD where it can find
  410. your EXITINFO.BBS file.  Requires full path and filename. 
  411. Default is current directory.
  412.  
  413.      ExitInfoPath c:\bbs\exitinfo.bbs
  414.  
  415.  
  416. ---
  417. UserPath
  418. - this descriptor is here for VD_Pack to use to find the
  419. Users.BBS file.  ValidOOR will ignore it.  Again a full path and
  420. filename is required.
  421.  
  422.      UserPath c:\bbs\users.bbs
  423.  
  424.  
  425. ---
  426. UserDir
  427. - This is the Path and filename of your User Directory where the
  428. names and phone numbers of validated users are stored.  This is
  429. to make sure that users cannot be validated twice at the same
  430. phone number. I use:
  431.  
  432.      UserDir c:\bbs\validoor.dir
  433.  
  434. This is an optional feature and may be disabled by commenting it
  435. out.
  436.  
  437.  
  438. ---
  439. BadNumber
  440. - This is the full Path and filename to your Bad Phone Number
  441. Control file.  This file is where any phone numbers that ValidOOR
  442. senses to be VOICE connects will be written and therefore
  443. prevented from ever being dialed by ValidOOR again.  If you wish
  444. you may use your BBS PHONENUM.CTL file for this, remembering that
  445. any numbers that end up in PHONENUM.CTL will never be dialed by
  446. ValidOOR.  Usage as follows:
  447.  
  448.      BadNumber d:\qbbs\badnumbr.ctl
  449.      BadNumber d:\qbbs\phonenum.ctl
  450.  
  451. If you do not wish to use this feature, simply comment it out. 
  452. It is optional.
  453.  
  454.  
  455. ---
  456. EditPhone
  457. - This allows a user to edit his phone number from within
  458. ValidOOR.  It has three parameters which do the following:
  459.  
  460.      EditPhone 0
  461.           Do not allow user to edit phone number
  462.      EditPhone 1
  463.           Allow user to edit phone number
  464.      EditPhone 2
  465.           Allow user to edit phone number & update Users.BBS
  466.  
  467.  
  468. ---
  469. ModemSuffix
  470. - This is for modems like the HST which can use a suffix after
  471. the phone number to cause a certain type of connection to be
  472. made.  Comment it out if you don't need it.  With my HST I use:
  473.  
  474.      ModemSuffix &M4
  475.  
  476.  
  477. ---
  478. WaitTime
  479. - This is the number of seconds to wait before the first
  480. attempted call and between each attempted call.  I suggest using
  481. 10 seconds:
  482.  
  483.      WaitTime 10
  484.  
  485.  
  486. ---
  487. OffHook
  488. - This is the string you wish to use to take your modem offhook
  489. during the above WaitTime to keep an incoming call from messing
  490. up VD's validation attempt.  I use this for my HST:
  491.  
  492.      OffHook ATH1|
  493.  
  494.  
  495.  
  496.  
  497.  
  498. ---
  499. OnHook
  500. - This string puts the modem back on hook after WaitTime before a
  501. call is made.  I use:
  502.  
  503.      OnHook ATH0|
  504.  
  505.  
  506. ---
  507. ValidGoodbye
  508. - This is the full path and filename to a text file that you wish
  509. to be displayed to the user who has been validated successfully. 
  510. I use:
  511.  
  512.      ValidGoodbye c:\bbs\text\validgb.asc
  513.  
  514. ---
  515. InValidGoodBye
  516. - This is the path to a text file to be displayed to a user that
  517. is not validated successfully. Mine is:
  518.  
  519.      InValidGoodbye c:\bbs\text\invaldgb.asc
  520.  
  521.  
  522. ---
  523. LDGoodbye
  524. - This file will be displayed to a user when Long Distance calls
  525. have been disabled. I use:
  526.  
  527.      LDGoodbye c:\bbs\text\ldgoodby.asc
  528.  
  529.  
  530. ---
  531. HitAnyKey
  532. - This is for High-Speed modem users who run with the port
  533. locked.  It places a "Hit ANY Key" at the end of each 'goodbye'
  534. file above, so that the user will see all of the file before the
  535. modem disconnects.  If your port is not locked use:
  536.  
  537.      HitAnyKey No
  538.  
  539. If your port is locked use:
  540.  
  541.      HitAnyKey Yes
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548. ---
  549. SlowModem
  550. - This descriptor enables commands sent to the modem slowly for
  551. modems that cannot respond to an initialization string sent at
  552. full blast! Usage:
  553.  
  554.      SlowModem On
  555.      SlowModem Off
  556.  
  557.  
  558. ---
  559. Display
  560. - This descriptor is used to enable Direct Screen writes for
  561. certain portions of ValidOOR.  It should be set:
  562.  
  563.      Display Direct
  564.  
  565. unless your system cannot handle direct writes for whatever
  566. reason.  Then you would use:
  567.  
  568.      Display BIOS
  569.  
  570. Using the BIOS option disables the color options below and also
  571. removes the Status Line.  It allows VD to operate in a Bare Mode
  572. which may be more stable on some machines.
  573.  
  574.  
  575. ---
  576. ForeGround
  577. BackGround
  578. - Color Attributes for Normal Activity Window
  579.  
  580. ---
  581. MessageForeGround
  582. MessageBackGround
  583. - Color Attributes for Message Bar
  584.  
  585. ---
  586. StatusForeground
  587. StatusBackground
  588. - Color Attributes for Status Info
  589.  
  590. ---
  591. WindowForeGround
  592. WindowBackGround
  593. - Color Attributes for Status Window
  594.  
  595. I  use these:
  596.  
  597.  
  598.      ForeGround 7
  599.      BackGround 0
  600.      MessageForeGround 4
  601.      MessageBackGround 7
  602.      StatusForeground 15
  603.      StatusBackground 3
  604.      WindowForeGround 0
  605.      WindowBackGround 3
  606.       
  607.  
  608. ---
  609. SecLevel
  610. - This is the security level you want to set validated users to:
  611.  
  612.      SecLevel 5
  613.  
  614. If you do not want Validoor to set any levels, then comment out
  615. this line.
  616.  
  617.  
  618. ---
  619. AFlag
  620. BFlag
  621. CFlag
  622. DFlag
  623. - These descriptors define the bit masks for the user flags. You
  624. set them just like you would in your user editor.  If you don't
  625. want VD to mess with user flags, just comment them out.  Using
  626. the letter 'n' in place of any bit will cause VD to leave that
  627. bit untouched.
  628.  
  629.      AFlag XXXX---n
  630.      % BFlag --------
  631.      CFlag X-X-X-Xn
  632.      % DFlag --------
  633.  
  634. Above the AFlag and CFlag would be set like above for a user who
  635. passes validation successfully.  The BFlag and DFlag would not be
  636. touched.  Bit 8 on both AFlag and CFlag would be untouched by
  637. ValidOOR.
  638.  
  639.  
  640. ---
  641. TimeLimit
  642. - Use this to set the new time limit for the user after he is
  643. validated.
  644.  
  645.      TimeLimit 60
  646.  
  647. would give a newly validated user 60 minutes.  This is useful if
  648. you let newly validated users back into your system after you
  649. call them (on your nickel).  Comment this out to disable this
  650. feature.
  651.  
  652.  
  653. ---
  654. TwitLine
  655. - This can be a line of text displayed to a user you have just
  656. 'Twitted' with the <F10> Twit key.
  657.  
  658.      TwitLine Please Call some other BBS
  659.  
  660.  
  661. ---
  662. ValidShell
  663. - This is used to get your system to run external programs after
  664. validating Users.  You may have up to 10 ValidShells which are
  665. executed in the order they are listed in VD.Cfg.  Example below
  666. would run the program Postit.Exe
  667.  
  668.      ValidShell Postit.Exe -t@UserName -f"Sysop" -mtext.txt
  669.  
  670. NOTE the use of the VDVariable @UserName.  ValidOOR will replace
  671. this variable with the user's name.  There are six VDVariables:
  672.  
  673.      @UserName           User's First & Last name
  674.                          Format: Cabell Clarke
  675.      @User_Name          Same as @UserName except
  676.                          Format: Cabell_Clarke
  677.      @Password           User's Password
  678.      @Version            ValidOOR Current Version
  679.      @VD_Date            Current Date
  680.      @VD_Time            Current Time
  681.  
  682.  
  683. ---
  684. UserComment
  685. - This will put a comment in the Usersxi.bbs file.  It also
  686. understands VDVariables.
  687.  
  688.      UserComment ValidOOR v@Version at @VD_Time on @VD_Date
  689.  
  690. %%%  End of VD.CFG  %%%
  691.  
  692. In ALL of the above descriptors the CASE is not significant but
  693. it may be in your modem commands depending on your modem.
  694.  
  695. The default filename for your configuration file is VD.CFG.  You
  696. may also tell Validoor the name of your configuration file on the
  697. command line when you run it like this:
  698.  
  699.     vd myvd.cfg
  700.        or
  701.     vd yourvd.cfg
  702.  
  703. You should NOT include a Path to your vd.cfg on the command line
  704. unless you are not using the ValidOOR environment variable.
  705.  
  706.  
  707.  
  708. Interfacing ValidOOR
  709. --------------------
  710. There are several ways you can run ValidOOR on your system.  I
  711. use a type 40 command in my TOP.MNU with flag D1 set ON (X) to
  712. force all new users into the validation menu.  After successful
  713. validation I set the D1 flag back off (-) and then when they hit
  714. TOP.MNU the 1st type 40 command will be ignored due to the flag
  715. not being ON and the TOP.MNU will execute normally.  I have
  716. included my menus in this archive to give you an idea as to how I
  717. do it.
  718.  
  719. You can also just use a Type 2 command to let your users access
  720. VD that way...  it is up to your personal preference as to how
  721. you get your users into ValidOOR.  Be creative :-).  That is why
  722. the system has been designed to be so open-ended.
  723.  
  724. Once the user selects ValidOOR, the BBS should exit via type 15
  725. or type 7 EXIT to run ValidOOR.  See your BBS documentation for
  726. an explanation of Type 7 and 15 Exits.  I use a type 15 EXIT to
  727. my RunRa.Bat file which then calls my Validate.Bat which I have
  728. included here.  When the Validate.Bat file runs it loads ValidOOR
  729. which then initializes the FOSSIL driver, and does some setup
  730. things - reads VD.CFG which you the sysop must set up, and then
  731. it looks for EXITINFO.BBS.
  732.  
  733. At this point, if you have opted to use a User Directory File to
  734. prevent duplicate phone numbers, VD will check for the existence
  735. of this file which it creates if not found.  If you comment out
  736. the UserDir descriptor in VD.Cfg, no dupe checking will be
  737. performed.
  738.  
  739. ValidOOR also creates a log file and appends info to it so you
  740. can keep track of it's activities.
  741.  
  742. ValidOOR can be set up to use either the business/data phone
  743. number, the home/voice phone number or both phone numbers that
  744. the user entered during his initial login depending on how you
  745. choose to set up your BBS.  You can also optionally allow the
  746. user to edit his phone number in two different ways - 1)
  747. temporary edit for calling which is not saved, or 2) edit which
  748. is saved into the DATAPHONE field in the users.bbs file.  If you
  749. are going to allow your users to edit their number from within
  750. ValidOOR it is highly recommended that you use option 2 and save
  751. the edits.  This is more secure.
  752.  
  753. ValidOOR will prompt the user to select which of the two numbers
  754. his modem is currently connected to and give him an option to
  755. abort the process should he so desire.  After this selection is
  756. made, ValidOOR will ask him if a 1- should be placed in front of
  757. the number for a long distance call.  If you choose not to let VD
  758. make long distance calls, the user will not be called and a file
  759. explaining the situation can be displayed (See VD.CFG descriptor
  760. LDGoodbye.  If Long distance calling is enabled, VD will place
  761. the 1- in front of his number and continue with the process.
  762.  
  763. If all files are present and everything went properly, ValidOOR
  764. will inform the user that he is about to be validated and display
  765. the following line:
  766.  
  767. "Prepare for an incoming call.  If your modem will not auto
  768. answer, when you see the RING on screen type ATA and hit
  769. <Enter>."
  770.  
  771. Then ValidOOR prompts him to hit <ENTER> when he is ready to
  772. begin.  When the user hits <ENTER> ValidOOR will disconnect him,
  773. take the phone off the hook, and wait a pre-defined number of
  774. seconds (WaitTime in VD.CFG).  The ValidOOR will put the modem
  775. back on the hook and call the user at the same baud rate that he
  776. used to log into the BBS. The number of "Non-Connect" attempts
  777. can be set up in VD.CFG but the system, after one connection is
  778. made, will not make another attempt to call.
  779.  
  780. If your modem is capable of sensing a VOICE connect, and your
  781. modem initialization string has the proper value sent to it to
  782. enable this feature, then when ValidOOR senses a VOICE connection
  783. and you have a path in the 'BadNumber' descriptor uncommented,
  784. ValidOOR will abort and write this phone number to a BadNumber
  785. Control file.  Then VD will never attempt to call this number
  786. again.  You may use your PHONENUM.CTL file in your BBS for this
  787. if you fully understand that no one ever be able to use this
  788. number to log in to your BBS as a new user again. Using X0 in
  789. your Modem Initialization string will totally disable modem
  790. result codes and then ValidOOR will ignore all of this entirely.
  791.  
  792. When the connection is successful, ValidOOR will display a brief
  793. message something like this:
  794.  
  795. ValidOOR v1.60
  796.  
  797. and then display the SysName1 and SysName2 messages that you set
  798. up in VD.CFG.  Next VD prompts the user to enter his password. 
  799. He gets three tries before ValidOOR gives up and disconnects.  An
  800. Inactivity timer which is configurable in VD.CFG will disconnect
  801. him if he falls asleep.  If he fails to enter the proper password
  802. (from EXITINFO.BBS) for whatever reason, the system will
  803. disconnect him and exit with an errorlevel 2.  Your batch file
  804. can then process the errorlevel accordingly.  An appropriate
  805. entry will be written to the log.
  806.  
  807. If he is successful, then ValidOOR will exit with an errorlevel
  808. 0.  Your batch file can process accordingly.  Also an entry will
  809. be written into the log file to let you know what happened.  If
  810. you have selected to do so in VD.CFG, and are running from a type
  811. 15 exit, ValidOOR will update the user's security and user flags
  812. in the EXITINFO.BBS
  813.  
  814. NOTE:  It is necessary to reload your BBS after VD exits using
  815. the command:
  816.  
  817. RA -R
  818.  
  819. in order for the changes in security level and user flags to take
  820. place.  If you do not reload your BBS the updates will NOT be
  821. written to the USERS.BBS file.  See my SPAWNBBS.BAT file for an
  822. exact example as to how this should be done.
  823.  
  824.  
  825. Function Keys
  826. -------------
  827. Some function keys are available to the sysop while a user is
  828. online.
  829.  
  830. <F1>  - Chat
  831. - Pressing this key will put you in Chat Mode with the caller. 
  832. Hitting <ESC> will exit the chat mode.
  833.  
  834. <F2>  - DOS
  835. - This key will allow you to shell to DOS via your Comspec
  836. variable.  Be sure you have set comspec in your environment.
  837.  
  838. <F3>  - Twit
  839. - This Key will set the callers access level to Zero (0) thus
  840. banning him from entering you system forever.  VD exits with
  841. errorlevel 18. Use this with caution and prudence.
  842.  
  843. <F4>  - Abort
  844. - This key simply aborts VD and exits with a DOS errorlevel 15.
  845.  
  846. <F5>  - HangUp
  847. - This key disconnects the user and exits with a DOS errorlevel
  848. 16.
  849.  
  850. <F10> - Advertisement
  851. - This key interrupts ValidOOR processing with an advertisement.
  852.  
  853.  
  854. Local Mode
  855. ----------
  856. ValidOOR has a Local Mode that a sysop can use for testing
  857. purposes.  You must exit (type 15 or 7) from the BBS (in local)
  858. for it to work.  VD can tell from Exitinfo.Bbs that you are in
  859. LOCAL mode and will react accordingly.  While in Local mode, VD
  860. will not check to see if the phone number exists in the User
  861. Directory file.  This will allow you to test as many times as you
  862. like without having to delete yourself from the User Directory
  863. every time.
  864.  
  865. In local mode, VD will skip the dialing and jump straight to
  866. Connection and attempt to validate you.  Your phone number will
  867. be written into the User Directory if you pass the validation.
  868.  
  869.  
  870.  
  871. ERRORLEVELS
  872. -----------
  873. Several cases will cause ValidOOR to abort with an errorlevel:
  874.  
  875. o  absence of any of these files:               errorlevel=1
  876.      EXITINFO.BBS
  877.      VD.CFG
  878.  
  879. o  User Not Validated                           errorlevel=2
  880.  
  881. o  SysopName missing in VD.CFG                  errorlevel=3
  882.  
  883. o  Duplicate Phone Number (in directory file)   errorlevel=4
  884.  
  885. o  User Abort at Menu                           errorlevel=5
  886.  
  887. o  Absence of FOSSIL Comm Driver                errorlevel=6
  888.  
  889. o  Long Distance attempt (if enabled)           errorlevel=7
  890.  
  891. o  Inactivity                                   errorlevel=8
  892.  
  893. o  Carrier Loss                                 errorlevel=9
  894.  
  895. o  VOICE connect detection                      errorlevel=10
  896.  
  897. o  Bad Number detected (BadNumber Control File) errorlevel=11
  898.  
  899. o  Bad KEY file                                 errorlevel=12
  900.  
  901. o  Invalid # of Command Line Args               errorlevel=13
  902.  
  903. o  User Edited invalid number                   errorlevel=14
  904.  
  905. o  F4 Abort key                                 errorlevel=15
  906.  
  907. o  F5 Hangup key                                errorlevel=16
  908.  
  909. o  Beta Copy expired (betas ONLY)               errorlevel=17
  910.  
  911. o  Twitted the current user                     errorlevel=18
  912.  
  913. o  FATAL System ERROR                           errorlevel=19
  914.  
  915. If the user is validated successfully, ValidOOR will exit with an
  916. errorlevel of 0.
  917.  
  918. These errorlevels are enabled in this release.  They are not
  919. guaranteed to remain the same in future versions.  You can take
  920. advantage of these errorlevels by trapping them all in your batch
  921. file and using the traps to generate entries in your log to give
  922. you a more verbose explanation of what went on....  be creative. 
  923. You can use them any way you like.
  924.  
  925.  
  926. Your KEY file
  927. -------------
  928. The ValidOOR Key file eliminates the 30 second delay at the
  929. beginning of the program.  You must register ValidOOR in order to
  930. get a key from me.  I can send the key via FidoNet mail or US
  931. Mail (Snail Mail).  Please specify which method you prefer when
  932. registering ValidOOR.
  933.  
  934.  
  935. Reporting Bugs
  936. --------------
  937. If you have a problem with ValiDOOR you should report it
  938. immediately to me.  When making a bug report, please include the
  939. following info in a ZIPPED file:
  940.  
  941.      A detailed description of the problem
  942.      A copy of your VD.CFG file
  943.      A copy of your log showing the problem if applicable
  944.      A copy of your UserDir if applicable
  945.      A copy of your badnumbr.ctl file if applicable
  946.  
  947. Without this info, it will be nearly impossible for me to find
  948. the problem.  Help me to help you.
  949.  
  950. The best place to report a problem in on my support system listed
  951. here:
  952.  
  953.      ValidOOR Support
  954.      The Boot Factory BBS
  955.      FidoNet 1:264/19
  956.      804-262-9289
  957.  
  958.  
  959. File Requests
  960. -------------
  961. Magic Filenames for File Requests from 1:264/19
  962.  
  963. FILES     : master download file list F264-019.ZIP
  964. NEWFILES  : Files less than 30 days old
  965. ABOUT     : General Info File
  966. VDR       : latest version of ValidOOR - for RA
  967. VDQ       :   "       "    "     "        "  QuickBBS
  968. The following utils will ONLY work with a key.
  969. VDP       : VD_Pack   - userdir packer for registered users
  970. VDU       : VD_Util   - userdir utility for registered users
  971. VDC       : VD_Create - userdir creator for registered users
  972.  
  973.  
  974. Credits
  975. -------
  976. Thanks to the following individuals:
  977.  
  978. Continental Software  -  The RemoteAccess folks.
  979. Robert Rosanio        -  who gave me the original idea.
  980. Greg Dawson           -  for teaching me how to access FOSSIL.
  981. Mike Janke            -  for his wonderful Exit code.
  982. Jim Whitby            -  for Documentation and other Help.
  983. Ed Greene             -  for his debugging help and reports.
  984. Richard Alfoni        -  for his debugging help and reports.
  985. Tom Meehan            -  Chief code basher/tester.
  986. Net 264               -  for tolerance.
  987.  
  988. Also Thanks to the Beta Testers....  All of you.
  989.  
  990.  
  991. Report ALL to:
  992. Cabell Clarke
  993. 804-262-9289 DATA
  994. FidoNet 1:264/19
  995.  
  996.  
  997.